home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 005 / grocer.arc / GROCERY.DOC < prev    next >
Encoding:
Text File  |  1987-05-14  |  12.3 KB  |  331 lines
  1.  
  2.  
  3.  
  4.                             Grocery Listing Program
  5.  
  6.                                  Version 1.2
  7.  
  8.                                     -by-
  9.  
  10.                          Synergy Software of Nebraska
  11.                               904 Lariat Circle
  12.                              Papillion, NE  68046
  13.  
  14.  
  15.         Synergy Software of Nebraska (SSoN) is distributing GROCERY under 
  16.         the  Public Domain concept.   This program may be freely  distri-
  17.         buted to all interested individuals without further authorization 
  18.         or  request from SSoN.   If you are interested in other  programs 
  19.         developed  by  SSoN,  you  can write to  the  above  address  for 
  20.         information.
  21.  
  22.         Since  GROCERY  is  being  distributed  without  any  charge   or 
  23.         obligation  by the user,  Synergy Software of Nebraska  disclaims 
  24.         all  responsibilities for its purpose or its effectiveness.   (In
  25.         other words, "Don't look a gift horse in the mouth.")
  26.  
  27.         If  you  like the program and would like to have a  copy  of  the 
  28.         source code,  you can send us $10 to the above address.   We will 
  29.         send you a copy.  The program was written in Turbo Pascal.
  30.  
  31.         This program  has been developed  to run with  only color display
  32.         systems.  Later versions will work with monochrome displays.
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                         1
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.         Into the fire pit:
  71.  
  72.              There  are  those who grocery shop on a regular  basis  that 
  73.         often know precisely what they want to get, where to find it, and 
  74.         how  many (or much) to buy.   Of course,  there are  those,  like 
  75.         myself,  who  dread the  local  Food-4-Less,  Piggly-Wiggly,  and 
  76.         Helter-Skelter  food chains;  who make illogical and often unsup-
  77.         ported  reasons why it is better to buy a dozen items at  the  7-
  78.         eleven  store  just down the street for the price of the  monthly
  79.         car  payment rather than beat the hords of food shoppers  at  the 
  80.         BIG ones;  and who look for building maps at the entrance in case 
  81.         of  getting lost "somewhere" between isles 7 and 8 while  seeking 
  82.         the location of a jar of Jif.
  83.  
  84.              Well,  despite my efforts, the day came when my wife gave me 
  85.         the  grocery list and simply stated:  "Go to it."  It was in  the 
  86.         two  hours  after this SEE (Significantly Emotional Event), while 
  87.         wearing  out  my  shoe soles in search of a  that  infintesimally 
  88.         small,  but ever so important, spice that I decided to write this 
  89.         program.
  90.  
  91.         The Program's Afoot:
  92.  
  93.              Within a day of previously described misadventure I had  the
  94.         workings of the program complete.   At last!  Not only did I have 
  95.         a  program  that I could use at the store,  but I  could  finally 
  96.         prove  to my wife that a computer DOES have useful  purposes.   I 
  97.         can  honestly  say now that having the  program  completed,  with 
  98.         several modifications as time goes on,  for nearly a year that my 
  99.         wife  consistently and faithfully uses it every time she goes  to 
  100.         her favorite grocery store.
  101.  
  102.         The Inner'ds:
  103.  
  104.              Since  there  is a built-in help screen (my wife  would  not 
  105.         have  had  much  luck running the program without being  able  to 
  106.         first  find the F1 key),  this document will be short.   It  will 
  107.         only cover a general description of what the program does.
  108.  
  109.              First of all,  GROCERY is a data base program.   It contains 
  110.         the  grocery  items you buy on a regular (or even  an  irregular) 
  111.         basis,  along  with  the normal amount of each  item.   When  you 
  112.         execute GROCERY, it will display the items by isle.
  113.  
  114.              1) enter new grocery items,
  115.              2) delete existing grocery items,
  116.              3) select grocery items to be printed, and
  117.              4) print the final grocery list (or entire data base).
  118.  
  119.              The  program  will handle up to 30 isles and each  isle  may 
  120.         have up to 36 items.   The display shows the items three isles at 
  121.         a time;  18 items per isle.   There are two "windows",  a top and 
  122.         bottom,  that  can be switched between which enables you to  view 
  123.         all 36 items (18 in the top window, 18 in the bottom window).
  124.  
  125.  
  126.  
  127.                                         2
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.              Items  are selected (or cleared) by placing the item  cursor 
  137.         (a inverted color window) over the item you are interested in and 
  138.         pressing  the RETURN key.   Once you have selected the items  you 
  139.         wish  to include in the grocery list,  the F3 function key  sends
  140.         the list to the printer (LPT1:).
  141.  
  142.              Of course the difficult part about running the program is in 
  143.         having  to  enter  ALL  of the items into the data  base  at  the 
  144.         beginning.   The  nice  thing  is that once you  have  the  items 
  145.         entered (and organized in the fashion you desire),  printing  the 
  146.         grocery  list is a snap;  and the print-out is organized by isle.  
  147.         All you have to do is go through the grocery store,  checking the
  148.         items by the isle.
  149.              Isles in the program are numbered 1 to 30;  however,  I have 
  150.         added  a feature that allows you to change the name of the  isle.  
  151.         Thus,  you  can  rename one of the isles  "Produce"  and  another 
  152.         "Meats".  This also simplifies the shopping procedures.
  153.  
  154.         Key Points:
  155.  
  156.              A) The function keys:
  157.  
  158.              F1: This  key  brings  up the first (of two)  help  screens.  
  159.                  These  screens provide a synopsis of the keys  that  are 
  160.                  available within the program.   To go to the second help 
  161.                  screen  page,  strike the F1 key again.   Any other  key 
  162.                  returns the main screen.
  163.  
  164.              F2: This  key  saves  the  present data base  to  the  file: 
  165.                  GROCERY.DB.   The data saved includes the items as  well 
  166.                  as the selection settings.   Thus,  you can select items 
  167.                  to  be printed,  save them to file,  and when you reload 
  168.                  the program, the selection settings are still there.
  169.  
  170.              F3: This  key  prints out the final  grocery  listing.   All
  171.                  print-out is organized by isle and the specific sequence 
  172.                  of items in the isles.
  173.  
  174.              F5: This key prints the entire data base.   This is good for 
  175.                  checking the data base against the grocery  store;  just 
  176.                  print  out  the data base and take it with you the  next 
  177.                  time you go shopping.
  178.  
  179.              F7: This key resets all selected grocery items.  It is meant 
  180.                  primarily  to clear the selection settings so  that  you 
  181.                  can  start from scratch with the next grocery list.   If 
  182.                  you select this option,  GROCERY will give you one  last 
  183.                  chance to abort the action: with the ESC key.
  184.  
  185.              F9: This  key sets the display to the TOP window.   As  men-
  186.                  tioned above,  there are two windows required to display 
  187.                  all 36 items for each isle:  TOP and BTM (Bottom).  This 
  188.                  key and F10 are available to switch between the two.
  189.  
  190.              F10:This  key  sets the display to the BTM (Bottom)  window.  
  191.  
  192.  
  193.                                         3
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.                  See the F9 key above for more information.
  203.  
  204.  
  205.              B) Cursor Movement Keys:
  206.  
  207.              The 4 Arrow Keys:
  208.                   These keys are the primary keys to move the item cursor
  209.              around  the display area of the screen.   The item cursor is 
  210.              used  to select or clear items for the grocery  listing,  to 
  211.              point to items to be deleted, or to point to locations where 
  212.              an item is to inserted in the list.
  213.                   In addition to the F9 and F10 keys described above, the 
  214.              arrow keys also can cause the display to switch between  the 
  215.              TOP and BTM windows.   If the cursor is placed over the last 
  216.              item in the TOP window (and there are items that extend into
  217.              the  BTM window),  the down arrow will cause the program  to 
  218.              display  the bottom window.   Likewise,  if the cursor is at 
  219.              the  first  item  on  the BTM window and  the  up  arrow  is 
  220.              pressed,  the program will display the top  window,  placing 
  221.              the cursor at the end of the top window's list.
  222.                   The  left  and right arrows "wrap" around  through  the 
  223.              three isles displayed.  To display the next three isles, use 
  224.              the page up and page down keys (described below).
  225.  
  226.              Home and End:
  227.                   In  addition  the the arrow keys described  above,  the 
  228.              Home and End keys also move the cursor.   The Home key moves 
  229.              the  item cursor to the first item on that particular  isle.  
  230.              If the BTM window is displayed,  the window is not switched.  
  231.              The End key moves the cursor to the end of the list.
  232.  
  233.              C) Paging:
  234.  
  235.                   GROCERY  only displays three isles of data at one time.  
  236.              Each of these three isle displays are called  pages.   Since 
  237.              there  are 30 isles in all and three isles are displayed per 
  238.              page,  there are a total of 10 pages.   To move from page to 
  239.              page,  the PgUp and PgDn keys are used.   PgUp moves back to
  240.              the  previous  page;  PgDn moves to  the  next.   For  quick 
  241.              "jumps",  holding the CTRL key down and striking the PgUp or 
  242.              PgDn  key will send you to the first page or the last  page, 
  243.              respectively.
  244.  
  245.              D) Other keys:
  246.              
  247.              RETURN:  This  key is used to toggles the item pointed to by 
  248.              the item cursor between selected and cleared.  If an item is 
  249.              clear,  and the RETURN key is pressed,  GROCERY will ask you 
  250.              for the quantity.   If you don't wish to change the quantity 
  251.              as shown,  press the RETURN key again;  otherwise,  you  may 
  252.              type in a value between 1 and 99.
  253.  
  254.              INS:  This  key allows you to insert new items into the data
  255.              base.   To  insert a new item,  place the item cursor at the 
  256.              location you wish it to be and press the INS  key.   GROCERY 
  257.  
  258.  
  259.                                         4
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.              will  ask you to enter the item.   Type in the name and  hit 
  269.              RETURN.  The item will be inserted.
  270.  
  271.              DEL:   This key deletes an existing item from the data base.  
  272.              Place  the  cursor over the item to be deleted and hit  DEL.  
  273.              GROCERY will ask you to verify the delete.  If you are sure, 
  274.              type "Y".
  275.  
  276.              CTRL-HOME:  As discussed above, it is possible to change the 
  277.              name of the isle which,  by default, is simply numbered from
  278.              1  to 30.   Text descriptors are often more  informative  of 
  279.              what  the  isle contains,  rather than just  a  number.   To 
  280.              change the name, hold down the CTRL key and press Home.  The 
  281.              item  cursor will jump to the screen location displaying the 
  282.              isle number.  Now, just type in the name.  To clear the name 
  283.              from the display, press CTRL-Home and hit RETURN.
  284.  
  285.              ESC:   Finally,  to  exit  the program,  use  the  ESC  key.
  286.              GROCERY  will ask you to verify this is what you wish to do.  
  287.              It  is  not necessary to save the data base to  file  before 
  288.              exiting the program.   GROCERY will do this automatically if 
  289.              you have updated any of the data.
  290.  
  291.  
  292.         That's it!  I hope you enjoy and use this program.  It has been a 
  293.         great value to my family.
  294.  
  295.         Happy hunting...
  296.         Synergy Software of Nebraska
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.                                         5
  326.  
  327.  
  328.  
  329.  
  330.  
  331.